home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_489 / mkbmap / mkbmap.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  146 lines
  1. Amiga bitmapped font builder
  2. ============================
  3.  
  4. MkBmap V1.0 Copyright Adrian Aylward 1991
  5.  
  6. You may freely copy, use, and modify this program.  The source is included
  7. in the distribution.
  8.  
  9. This program builds Amiga format bitmapped fonts from PostScript fonts.
  10. It uses the library "post.library" to render the characters.  This is
  11. included in the PostScript interpreter package "Post" that is freely
  12. distributable on the Amiga.
  13.  
  14. Best results will be obtained by using fully hinted type 1 fonts, such as
  15. those supplied by Adobe and other vendors.  It should however work with
  16. any other PostScript fonts, though the quality will not be so high.
  17.  
  18. Command line interface
  19. ======================
  20.  
  21. usage:
  22.  
  23.     mkbmap -options bmapfile fontname nn,nn,...
  24.  
  25. options:
  26.  
  27.         -s startupfile
  28.                 The PostScript library startup file name.  Default
  29.                 "PSFonts:init.ps".
  30.  
  31.         -e encodingfile
  32.                 The character set encoding file.  Default
  33.                 "PSFonts:encoding.ps".
  34.  
  35.         -f      Use font specific encoding - for fonts such as "Symbol"
  36.                 where the character names are non-standard.
  37.  
  38.         -n      Make new .font contents file.  Updates the font directory
  39.                 information, like running the FixFonst program, but updating
  40.                 just the particular font.
  41.  
  42.         -dnnn   Set the density, in dots per inch, both x and y directions.
  43.                 Default is 75 dpi..
  44.  
  45.         -xnnn   Set the x density.
  46.  
  47.         -ynnn   Set the y density.
  48.  
  49.         -znnn   Set the baseline, in units of 1/1000 of the pixel height.
  50.                 Default automatically accomodates the descenders.
  51.  
  52.         -wnnn   Set the nominal character width, in units of 1/1000 of the
  53.                 character cell.  Default is the average width of all the
  54.                 characters.
  55.  
  56.         -lnnn   Set LoChar, the lowest character code value in the font.
  57.                 Default 32.
  58.  
  59.         -hnnn   Set HiChar, the highest character code value in the font.
  60.                 Default 255.
  61.  
  62.         -m      Flag the font as monospaced, i.e. not proportionally
  63.                 spaced.  Should only be used if all the characters in the
  64.                 font actually are the same width, e.g. Courier.
  65.  
  66.         -b      Set Bold style flag.
  67.  
  68.         -i      Set Italic style flag.
  69.  
  70.         -t      Turn trace on, for debugging.
  71.  
  72. The "bmapfile" argument is the name of the bitmapped font file to be created.
  73. So that more than one size can be created at once, the name can be specified
  74. as a prototype.  Any "*" characters are replaced by the point size, and any
  75. "?" characters are replaced by teh individual digits.  For example if we
  76. generate 9 and 10 point then "fonts:fred/*" will become "fonts:fred/9" and
  77. "fonts:fred/10"; "t:fred??" wil become "t:fred09" and "t:fred10".
  78.  
  79. The "fontname" is the PostScript font name, for example "Palatino-Roman".
  80.  
  81. The last argument is the list of point sizes to be generated, for example
  82. "10,12,24".  The minimum size allowed is 5, and the maxium 500 - if you
  83. have enough memory.
  84.  
  85. Normally, all three arguments are required.  However, if just the first
  86. argument is given then the "-n" option may be used to update the font
  87. contents.
  88.  
  89. For example:
  90.  
  91.     mkbmap -n fonts:Times/* Times-Roman 10,12,14
  92.  
  93. Creates bitmapped versions of the "Times" font in the current fonts
  94. directory, updating the font contents file "fonts:Times.font" so they
  95. become immediately available to the system.
  96.  
  97.     mkbmap t:Times24 Times-Roman 24
  98.  
  99. Creates a bitmapped 24 point "Times" in the temporary directory.  If
  100. you then copy it into the fonts: directory:
  101.  
  102.     copy t:Times24 fonts:Times/24
  103.  
  104. you must then either run FixFonts or use mkbmap to update the font contents:
  105.  
  106.     mkbmap -n fonts:Times/
  107.  
  108. The font is now available for use.  N.B. the trailing "/" on the path name
  109. must not be omitted; otherwise it will be looking for individual bitmaps
  110. within the fonts:directory, rather than in the Times subdirsctory.
  111.  
  112. If you use the "-n" option, the font subdirectory will be created
  113. automatically if necessary.
  114.  
  115. Character sizes
  116. ===============
  117.  
  118. The size list is the heights of the generated bitmaps, in pixels.  This is
  119. also the point size (in PostScript terminology) at the chosen resolution.
  120. When characters are rendered at 75 dpi. (the default) the alphabet normally
  121. fits satisfactorily into the pixel height.  However the upper case accented
  122. characters are normally too large to fit, so are scaled down.  Excessively
  123. long descenders are scaled too.  This can lead to a slightly ragged look on
  124. the screen, but fortunately these characters are rarely used.
  125.  
  126. Alternatively, you can adjust the density to make the charecters fit.  At
  127. about 60dpi. even the tallest characers should be OK.  But the characters
  128. may then look too small in relation to the line spacing.
  129.  
  130. If you are generating a font for a screen where the pixels are not
  131. approximately square (such as high-res, non-interlaced) you can set the
  132. x and y density separately.
  133.  
  134. Professional Page renders its screen at 75 dpi., so you should normally use
  135. the default density when generating fonts for it.
  136.  
  137. The baseline is normally positioned automatically, so the alphabetic
  138. descenders just fit.  If you prefer you can set it yourself; values of
  139. 200 - 250 are about right (1/5 to 1/4 of the pixels below the baseline.
  140.  
  141. The Xsize (nominal width) is automatically set to the average width of
  142. the characters generated.  You can set it yourself from the command line;
  143. values will typically range from 300 to 700 (in 1/1000 character space
  144. coordinates used by Adobe).
  145.  
  146.